package com.example.demo.mapper;

import com.example.demo.entity.Article;
import com.example.demo.entity.Tag;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 文章数据访问层接口
 * 负责文章相关的数据库操作
 */
@Mapper
public interface ArticleMapper {
    
    /**
     * 根据ID查询文章（包含关联信息）
     * @param id 文章ID
     * @return 文章信息
     */
    Article selectById(@Param("id") Long id);
    
    /**
     * 根据ID查询文章（简单查询，不包含关联信息）
     * @param id 文章ID
     * @return 文章信息
     */
    Article selectSimpleById(@Param("id") Long id);
    
    /**
     * 分页查询文章列表
     * @param offset 偏移量
     * @param limit 每页数量
     * @param categoryId 分类ID（可选）
     * @param status 状态筛选（可选）
     * @param keyword 关键词搜索（可选）
     * @return 文章列表
     */
    List<Article> selectArticleList(@Param("offset") int offset, 
                                   @Param("limit") int limit,
                                   @Param("categoryId") Long categoryId,
                                   @Param("status") Integer status,
                                   @Param("keyword") String keyword);
    
    /**
     * 查询文章总数
     * @param categoryId 分类ID（可选）
     * @param status 状态筛选（可选）
     * @param keyword 关键词搜索（可选）
     * @return 文章总数
     */
    int countArticles(@Param("categoryId") Long categoryId,
                     @Param("status") Integer status,
                     @Param("keyword") String keyword);
    
    /**
     * 查询置顶文章列表
     * @param limit 数量限制
     * @return 置顶文章列表
     */
    List<Article> selectTopArticles(@Param("limit") int limit);
    
    /**
     * 查询最新文章列表
     * @param limit 数量限制
     * @return 最新文章列表
     */
    List<Article> selectRecentArticles(@Param("limit") int limit);
    
    /**
     * 查询热门文章列表（按阅读量排序）
     * @param limit 数量限制
     * @return 热门文章列表
     */
    List<Article> selectPopularArticles(@Param("limit") int limit);
    
    /**
     * 根据标签ID查询文章列表
     * @param tagId 标签ID
     * @param offset 偏移量
     * @param limit 每页数量
     * @return 文章列表
     */
    List<Article> selectArticlesByTag(@Param("tagId") Long tagId,
                                     @Param("offset") int offset,
                                     @Param("limit") int limit);
    
    /**
     * 根据作者ID查询文章列表
     * @param authorId 作者ID
     * @param offset 偏移量
     * @param limit 每页数量
     * @return 文章列表
     */
    List<Article> selectArticlesByAuthor(@Param("authorId") Long authorId,
                                        @Param("offset") int offset,
                                        @Param("limit") int limit);
    
    /**
     * 插入文章
     * @param article 文章信息
     * @return 影响的行数
     */
    int insert(Article article);
    
    /**
     * 更新文章
     * @param article 文章信息
     * @return 影响的行数
     */
    int update(Article article);
    
    /**
     * 更新文章状态
     * @param id 文章ID
     * @param status 新状态
     * @return 影响的行数
     */
    int updateStatus(@Param("id") Long id, @Param("status") Integer status);
    
    /**
     * 增加文章阅读量
     * @param id 文章ID
     * @param increment 增加数量，默认为1
     * @return 影响的行数
     */
    int incrementViewCount(@Param("id") Long id, @Param("increment") int increment);
    
    /**
     * 增加文章点赞数
     * @param id 文章ID
     * @param increment 增加数量
     * @return 影响的行数
     */
    int incrementLikeCount(@Param("id") Long id, @Param("increment") int increment);
    
    /**
     * 更新文章评论数
     * @param id 文章ID
     * @param commentCount 评论数量
     * @return 影响的行数
     */
    int updateCommentCount(@Param("id") Long id, @Param("commentCount") Long commentCount);
    
    /**
     * 根据ID删除文章
     * @param id 文章ID
     * @return 影响的行数
     */
    int deleteById(@Param("id") Long id);
    
    /**
     * 查询文章的标签列表
     * @param articleId 文章ID
     * @return 标签列表
     */
    List<Tag> selectTagsByArticleId(@Param("articleId") Long articleId);
    
    /**
     * 删除文章的所有标签关联
     * @param articleId 文章ID
     * @return 影响的行数
     */
    int deleteArticleTags(@Param("articleId") Long articleId);
    
    /**
     * 添加文章标签关联
     * @param articleId 文章ID
     * @param tagId 标签ID
     * @return 影响的行数
     */
    int insertArticleTag(@Param("articleId") Long articleId, @Param("tagId") Long tagId);
    
    /**
     * 查询文章总数
     * @return 文章总数
     */
    long selectTotalCount();
    
    /**
     * 查询总浏览量
     * @return 总浏览量
     */
    long selectTotalViewCount();
}
